home *** CD-ROM | disk | FTP | other *** search
/ How to Get Online 1996 Spring / HOW2GON.ISO / mac / Desktop Folder / How To Get Online / MISC / PCPICO / install.txt next >
Encoding:
Text File  |  1996-03-03  |  12.1 KB  |  297 lines  |  [TEXT/ttxt]
  1.                        Pine 3.91 RELEASE NOTES 
  2.                          Specific To PC-PINE
  3.                              October 1994
  4.  
  5. Copyright 1989-1994 University of Washington.  
  6. Pine and Pico are trademarks of the University of Washington.
  7.  
  8. INTRODUCTION
  9.  
  10. Version 3.91 is a maintenance release of PINE --a Program for Internet
  11. News & Email.  The general release notes for Pine 3.91 are available
  12. via the "R" command on the Main Menu.  This file contains information
  13. that is particular to PC-Pine.  We assume that you are generally familiar
  14. with Pine; if not, additional information resources include:
  15.  
  16.   o The builtin context-sensitive Help screens in Pine.
  17.   o The comp.mail.pine newsgroup.
  18.   o The anonymous FTP archives at ftp://ftp.cac.washington.edu/pine
  19.   o The World-Wide-Web page at http://www.cac.washington.edu/pine
  20.  
  21. There are five versions of PC-Pine:
  22.  
  23.   o DOS: FTP Inc's PC-TCP
  24.   o DOS: Novell's LAN Workplace for DOS
  25.   o DOS: Sun's PC-NFS
  26.   o DOS: WATTCP/Packet Driver
  27.   o Windows: Winsock
  28.  
  29. The Winsock version is not a full Windows GUI application; it has the same
  30. user interface as the Unix and DOS versions of Pine.
  31.  
  32. KNOWN BUGS
  33.  
  34. There are several bugs that we already know about:
  35.  
  36.   o The mouse cannot be used to select commands from the Main Menu,
  37.     except via the key menu at the bottom of the screen, nor can you 
  38.     directly select by mouse folders, addresses, or config options from 
  39.     their respective screens.
  40.  
  41.   o Clicking on the "Ret Accept" field in the key menu does not select
  42.     the command, instead it puts "R"s into the text input buffer.
  43.     (Winsock version only?)
  44.  
  45.   o You cannot (yet) mount a Unix directory (via NFS or SMB) and successfully
  46.     share the same .newsrc file between your Unix and PC versions of Pine. 
  47.  
  48.   o The Winsock version is preliminary; we know that there are a number
  49.     of things that need to be done,  but your comments pro or con are
  50.     most welcome.)
  51.  
  52. INSTALLATION INSTRUCTIONS  
  53.  
  54. If you've made it this far, then you have already picked up a copy of
  55. PC-Pine that is appropriate for your networking software and "unzipped"
  56. the files in a directory (probably C:\Pine) on your PC's disk drive.  In
  57. the case of PC-Pine for Winsock, assuming you have Winsock/TCP/IP
  58. networking software already installed, you can now use the Windows file
  59. manager to create a new program item, or just use the "Run" option in the
  60. program manager to start out.  For the DOS versions, there are only a few
  61. more things you have to do to get Pine rolling: 
  62.  
  63. ----------------------------------
  64. Setting up the Networking Software
  65. ----------------------------------
  66.   
  67.    We assume that your DOS networking software has been installed and
  68.    configured for regular use.  If it has not, you must do that before
  69.    using Pine. 
  70.  
  71.    There are some additional steps that must be taken by users of
  72.    packet drivers, or older verisons of FTP, Inc.'s PC/TCP. Those steps
  73.    are explained below. 
  74.  
  75.     PCs with a Packet Driver:
  76.     -------------------------
  77.    
  78.        A) Edit the file WATTCP.CFG in the PC-Pine distribution to set
  79.           the PC's TCP/IP configuration.  Simply edit the file to do this.
  80.  
  81.        B) Every time Pine runs, it needs to be able to "see" the 
  82.           WATTCP.CFG file you just configured above.  To do that, you 
  83.           must add an environment variable "WATTCP.CFG" to the file
  84.           AUTOEXEC.BAT.  Here are the step-by-step instructions:
  85.  
  86.             1) Edit the file C:\AUTOEXEC.BAT to add the following line -
  87.                         set WATTCP.CFG=C:\PINE
  88.  
  89.             2) Save the file and reboot your computer.
  90.  
  91.           You will only have to do this packet driver specific configura-
  92.           tion work once.
  93.  
  94.        X) ADDITIONAL NOTE: If you have a running version of NCSA telnet,
  95.       already installed on you PC, its "CONFIG.TEL" file can be used
  96.       instead of the WATTCP.CFG file.  PC-Pine has a basic understanding
  97.       of the CONFIG.TEL format, and will recogize the "CONFIGTEL" 
  98.       environment variable in the absence of a "WATTCP.CFG" environment
  99.       variable.
  100.  
  101.     PCs with a PC/TCP Version Less than 2.2
  102.     ---------------------------------------
  103.     
  104.        A) You need a configuration file called "PCTCP.INI" in the Pine
  105.           directory.  This can be created in one of two ways:
  106.         
  107.             - If you have the program "Trans.exe" provided by FTP, Inc.,
  108.               then you can run this command:
  109.                   trans ifcust0.sys > C:\Pine\pctcp.ini
  110.  
  111.             - If you don't have "Trans.exe" or if that command does not 
  112.               work for you, then create the file by hand.  It needs to
  113.               contain just these two lines:
  114.  
  115.                   [pctcp ifcust 0]
  116.                   ip-address=<your_pc's_ip_address>
  117.  
  118.               Replace <your_pc's_ip_address> with the 4-section number 
  119.               appropriate for your computer.
  120.  
  121.        B) Every time Pine runs, it needs to be able to "see" the
  122.           PCTCP.INI file you just configured above.  To do that, you
  123.           must add an environment variable "PCTCP.INI" to the file
  124.           AUTOEXEC.BAT.  Here are the step-by-step instructions:
  125.               
  126.             1) Edit the file C:\AUTOEXEC.BAT to add the following line -
  127.                    set PCTCP=C:\PINE\PCTCP.INI
  128.  
  129.             2) Save the file and reboot your computer.
  130.                   
  131.           You will only have to do this PC/TCP specific configuration 
  132.           work once.
  133.  
  134. -----------------------------------
  135. Essential Configuration Information
  136. -----------------------------------
  137.  
  138.    When you start PC-Pine for the first time, the program will prompt
  139.    you for certain information which it needs as it needs it.  That 
  140.    configuration data is written to PC-Pine's configuration file (named
  141.    PINERC in the directory you unpacked pine in), so you will not have
  142.    to enter it every time.
  143.  
  144.    You should be preprared for the questions as PC-Pine can't really
  145.    proceed without the answers.  If you make an error in any of these
  146.    entries, you can correct it in Pine's SETUP CONFIGURATION screen
  147.    (type "S" then "C" from the Main Menu).
  148.  
  149.    Inbox
  150.    -----
  151.       When you read mail with PC-Pine, your mail is not delivered to your
  152.       PC directly.  Rather, email is delivered to an IMAP server which 
  153.       has been previously set up by your department/university/institution.
  154.       When you first start Pine, you need to specify where your INBOX
  155.       is.  The syntax is this:   {imap-server.domain}INBOX
  156.  
  157.    User-id
  158.    -------
  159.       This is the user-id part of your email address.
  160.  
  161.    Personal name 
  162.    -------------
  163.       Your name as you want it to appear on outgoing email.  You may have 
  164.       spaces and puctuation in the name.
  165.  
  166.    Host/domain
  167.    -----------
  168.       The "host" portion of your email address.  This may be the full name 
  169.       of the computer where your inbox resides or your departmental/
  170.       institutional domain if mail forwarding is set up.  NOTE: You should
  171.       not put the name of your PC as the answer to this question -- your
  172.       PC is not where your INBOX resides.
  173.  
  174.    SMTP server 
  175.    -----------
  176.       Your PC does not have the software to interact with Internet email 
  177.       directly.  It must rely on an SMTP server to actually send your 
  178.       message.  You need to set this to the full name of the computer at
  179.       your site which provides SMTP service.
  180.  
  181.  
  182.    Example:  Suppose the PC-Pine user is named "Joe User" and has
  183.    the login/email address of "juser".  The individual is at the
  184.    University of Examples and takes advantage of the general
  185.    domain of "u.example.edu".  He has set up his email so that  
  186.    email is delivered to his inbox on the machine "imap.example.edu".  
  187.    The University has set up an SMTP server on the machine named
  188.    "smtp-relay.example.edu".  The PC running PC-Pine is on the campus
  189.    network and is called "pc-joe".
  190.  
  191.    That person would answer PC Pine's configuration questions like this:
  192.  
  193.            INBOX             {imap.example.edu}INBOX
  194.            User-id           juser
  195.            Personal Name     Joe User
  196.            Host/domain       u.example.edu
  197.            SMTP Server       smtp-relay.example.edu
  198.  
  199.    Email coming from the account would look like this:
  200.  
  201.          --------------  Sample Email -----------------
  202.          Date: Mon, 16 July 1993 08:45:43 -0700
  203.          From: Joe User <juser@u.example.edu>
  204.          To: Pine Development Team <pine-bugs@cac.washington.edu>
  205.          Subject: My First Message
  206.  
  207. -------------------
  208. Local Support Files
  209. -------------------
  210.  
  211. In Pine 3.91, the Release Notes (Press "R" on the Main Menu) contain a
  212. section on Configuration, including default file names and environment
  213. variables. In brief, PC-Pine uses the following rules for finding config and
  214. support files: 
  215.  
  216.  1. The location of the PINERC is searched for in the following order of
  217.    precedence: 
  218.     1. File pointed to by PINERC environment variable 
  219.     2. $HOME\PINE\PINERC 
  220.     3. A file named PINERC in the same directory as PINE.EXE 
  221.  
  222.  2. The HOME environment variable, if not set, defaults to root of the
  223.     current working drive. 
  224.  
  225.  3. The default for most support files (e.g. PINE.SIG and ADDRBOOK) is 
  226.     the same directory as the PINERC file. 
  227.  
  228.  4. The support files (PINE.HLP and PINE.NDX) must be in the
  229.     same directory as PINE.EXE. 
  230.  
  231. Descriptions of these files follows:
  232.  
  233.    PINERC
  234.    ------
  235.         The Pine configuration file.  It contains all of Pine's config-
  236.         uration information -- much more than just the essentials listed
  237.         above.  There are comments in the PINERC to help you out.  Also,
  238.         PC-Pine comes with a sample PINERC you can use as a model.  See
  239.         the release notes for this version (they are compiled into the
  240.         program) for more details.
  241.  
  242.    ADDRBOOK
  243.    --------
  244.         Your Pine address book.  All the tools you need to manage the 
  245.         address book are in Pine itself, so you shouldn't need to worry
  246.         about this.
  247.  
  248.    PINE.SIG
  249.    --------
  250.         Your signature file.  If this file exists, Pine will automatically
  251.         insert it into every outgoing message.  You can specify a 
  252.         different name for this file in the PINERC if you like.
  253.  
  254.    NEWSRC  
  255.    ------
  256.         The NEWSRC is your subscription list for newsgroups.  By default
  257.         Pine will create this file in the same directory as your PINERC,
  258.         but will recognize it in your $HOME directory as well.  You can
  259.         specify a different name for this file in the PINERC if you like.
  260.  
  261.    MAILCAP  
  262.    -------
  263.         The MAILCAP file is not required by PC-Pine for normal operation,
  264.         but is the configuration file that can be used to help PC-Pine
  265.         deal with types and subtypes of MIME attachments it doesn't
  266.         have builtin knowledge of.  The MAILCAP file is automatically
  267.         recognized in either the same directory as your PINERC or the
  268.     same directory as PINE.EXE.  You can specify a different MAILCAP
  269.         file (or files) using the MAILCAPS environment variable which 
  270.         takes a semicolon delimited list of locations.  A sample MAILCAP,
  271.         MAILCAP.SAM, is included in the distribution to help get started.
  272.  
  273. ---------------------------
  274. Local Directory for Folders
  275. ---------------------------
  276.  
  277. Another important directory to PC-Pine is the location for local mail
  278. folders.  By default, PC-Pine will create the directory $HOME\MAIL to use
  279. as the directory to store mail you save to the local disk.  If the $HOME
  280. environment variable is not defined, PC-Pine will assume the root of the
  281. current working drive.  This location can be overridden by changing or
  282. adding "folder-collections" definitions in PC-Pine's SETUP CONFIGURATION
  283. screen.
  284.  
  285. ---------------------------------------------------
  286. Checking for and Retrieving Future PC-Pine Versions
  287. ---------------------------------------------------
  288.  
  289. Once you have PC-Pine working, you can use it to get its own updates.  If
  290. you see bugs in PC-Pine and want to find out if you have the most current
  291. version or if you know there is a more current version and need to get it,
  292. try Pine's Update command, which will connect you to the Pine update
  293. server, which always holds the most current version of PC-Pine and also a
  294. document entitled Pine Technical Notes. You will find "Update" as one of
  295. your options in the "Setup" section from Pine's main menu. 
  296.  
  297.